Api.CreateAsync 方法

准备将程式以非同步作业方式连结到 KINGSTAR 子系统。

命名空间：IntervalZero.KINGSTAR.OpcUa.Api

组合： IntervalZero.KINGSTAR.OpcUa.Api (于 IntervalZero.KINGSTAR.OpcUa.Client.dll) 版本：4.4.0.0

语法

public async Task<KsError> CreateAsync(
       int Instance,
       int IdealProcessor
)

Public Function CreateAsync(
       Instance As Integer,
       IdealProcessor As Integer
) As Task(Of KsError)

参数

Instance

型别：int

若您已启动 多主站套件，可选择欲使用的 KINGSTAR Runtime 实例；若您未启动该套件，请将其设定为零 (0)；若有三个实例而欲使用第三个，请将其设定为二 (2)，实例的数量取决于您的授权。

IdealProcessor

型别：int

设定 KINGSTAR 子系统运作的核心。子系统的所有执行绪将在给定的处理器上运作。核心零固定分配给 Windows。您可根据您的设定将其他核心分配给子系统。预设情况下，IdealProcessor 设定为零，表示 KINGSTAR 将使用实例配置表中所配置的处理器（KINGSTAR 控制台 > Runtime 设定 > 一般设定）。若该表中缺少给定实例的设定，则子系统可在 RTX64 可用的任何核心上运作。若您将 IdealProcessor 设定为其他数字，例如二，则子系统将使用核心二。

回传值

型别：Task<KsError>

Task：代表一个非同步作业。

KsError：方法的回传代码。

备注

• 此方法应第一个被呼叫。若未先呼叫 Create 方法，则所有其他方法都会回传错误。
• 若未启动 多主站套件，使用此方法且 Instance 设定大于零时，将回传 errNoLicense。在没有 多主站套件 的情况下，仅能将 Instance 设定为零。
• 多实例代表您有多个 ksRuntime.rtss 同时执行中且控制著不同的网卡，若您备有 多主站套件，可使用多个 Create 来建构多个实例。例如，有三个 Create 函式，则这些函式可各自使用实例零、一和二；若没有 多主站套件，您可使用多个 Create 来建构唯一一个实例，即实例零。多个应用程式可连结到同一个 KINGSTAR Runtime，但单一应用程式不可连结到多个 KINGSTAR Runtime。
• 一个 KINGSTAR Runtime = 一个 ksRuntime.rtss。
• Create 方法不能从执行绪集区或背景执行绪中呼叫，因为某些 RTX64 元件无法从这些位置初始化。

范例

N/A

参见

Api 类别

IntervalZero.KINGSTAR.OpcUa.Api 命名空间